home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #5 & #6 / Amiga Plus CD - 1995 - No. 5 and 6.iso / pd / netz / nntpd / install < prev    next >
Text File  |  1995-08-16  |  8KB  |  246 lines
  1. Installation for a working News system
  2. --------------------------------------
  3.  
  4.  
  5. 1) First follow the directions in NNTPd.doc for installation.
  6.  
  7. 2) If you have an active file already, skip to #3.
  8.  
  9.    If you do not have an active file, edit the file called active.all which
  10.    should now be located in your uunews directory, and select the newsgroups
  11.    that you wish to maintain on your system.  Save the edited file as: active
  12.  
  13.    Note that you MUST have newsgroup entries for control and junk, so do not
  14.    delete the first two entries in active.all!
  15.  
  16.    CD to your uunews directory and type:
  17.  
  18.     bin/activesetup
  19.  
  20.    This will create the subdirectories for your news if they do not
  21.    already exist.
  22.  
  23.  
  24. 3) If you already have a properly maintained active.times file, skip to #4.
  25.  
  26.    CD to your uunews directory and type:
  27.  
  28.     bin/activetimesmaker
  29.  
  30.    This will create a file called active.times in your uunews directory.
  31.  
  32. 4) If you already have an history database in your uunews directory, skip
  33.    to #5.
  34.  
  35.    CD to your uunews directory and type:
  36.  
  37.     bin/mkhistory
  38.  
  39.    The time that this utility takes depends on how extensive of a news
  40.    system you already have.  If you have no or very few newsgroups with
  41.    articles, this will be done quickly.  If you have the entire news system
  42.    stored on your system, start this and go to bed.  Also, this function is
  43.    a storage space hog, so have at least 200*number of articles of free space
  44.    available.
  45.  
  46. 5) You should now have the following files in your uunews dir:
  47.  
  48.     active
  49.     active.times
  50.     history
  51.     history.dir
  52.     history.pag
  53.  
  54.    Verify that they are all there. If they aren't, start over.
  55.  
  56. 6) Next you will build the .overview files in each of the subdirectories. CD
  57.    to your uunews directory and type:
  58.  
  59.     bin/initov
  60.  
  61.    This utility has to open up every article and extract the header from the
  62.    article, so it too will take a while if you have an extensive news system.
  63.  
  64. 7) Decide which NNTP servers you wish to forward your posts to and add them
  65.    to the uunews:sys file.  Example:
  66.  
  67.     You want to add foo.bar.edu to your distribution and forward to them
  68.     all articles in alt, bin, comp, and local.
  69.  
  70.     Add the following line to your sys file:
  71.  
  72.     foo.bar.edu:alt,bin,comp,local,to.news/all,!ut:F:foo.bar.edu
  73.  
  74.    *NOTE*
  75.    ------
  76.  
  77.    Yes, I realize what the sys manpages say, but this is the way it works.
  78.    You can do whatever you want, but the above works, and your way may not.
  79.  
  80.  
  81. 8) At this point the daemon will run, accept and forward posts.
  82.  
  83. 9) At regular intervals, you will need to process the news you have in your
  84.    spool directory.  Use relaynews to process each of the files in your spool
  85.    directory. Then update your overview files using domkov. Finally, process
  86.    the batches using batchproc.  Batchproc forwards out your news to other
  87.    systems using Michael van Elst's nntpput (archive included in its
  88.    entirety). Cron is a good tool which runs programs at regular intervals.
  89.    An example script to run, say, every 1/2-1 hour, follows:
  90.  
  91.     cd uunews:
  92.     bin/relaynews
  93.     bin/domkov <headers       <----- Sorry, but, yes, this is a redirect.
  94.     bin/batchproc             <----- Add -p here if you want your system
  95.                      to forward all news as NEW posts,
  96.                      otherwise leave this blank, and all
  97.                      posts will be forwarded with IHAVE.
  98.                      See batchproc below for more details.
  99.  
  100. 10)Daily, you probably will want to expire old news to make room for the new
  101.    news.  Cron is also useful for this. The script doexpire, located in
  102.    the uunews directory, does this.  It also updates your active file.
  103.    *Note* that the server is NOT functional when this routine is running, and
  104.    all people connecting during this time will receive a maintenance in
  105.    progress message, and all connected people will be disconnected on their
  106.    next command entry.
  107.  
  108.    ***Edit expire before running it if you do not have uunews: assigned to
  109.       your uunews directory.  You will need to change all of the cd uunews:
  110.       to wherever your uunews directory is located.
  111.  
  112.    The articles are expired based on the contents of explist.  Edit the
  113.    file explist.eg, located in your uunews directory, and save the file
  114.    as explist.  The man pages will help you edit this file to your liking.
  115.  
  116. ------------------------------------------------------------------------------
  117.  
  118.  
  119. These utilities exist in your uunews/bin directory:
  120.  
  121.     activesetup
  122.     relaynews
  123.     doexpire
  124.     expire
  125.     mkdbz
  126.     dbz
  127.     activeupdate
  128.     mkhistory
  129.     unixsort
  130.     histinfo
  131.     activetimesmaker
  132.     newgroup
  133.     initov
  134.     expov
  135.     expovguts
  136.     domkov
  137.     ovsplit
  138.     batchproc
  139.  
  140. activesetup
  141.  
  142.     This program takes your active file and creates subdirectories for
  143.     each newsgroup if needed.  It is usually only run once during the
  144.     initial installation of NNTPd.
  145.  
  146.  
  147. relaynews
  148.  
  149.     This will take all incoming messages in your UUSPOOL directory and 
  150.     place them in the proper directory.  It also adds the entries to your
  151.     history file. I have no idea if RelayNews works beyond the above use
  152.     because I haven't the slightest idea how it works.  Someone with
  153.     knowledge want to share it with me?
  154.     
  155.  
  156. doexpire/expire
  157.  
  158.     See the expire manpage to learn how to manipulate the explist in your
  159.     uunews directory.  An example should be in your uunews directory
  160.     under explist.eg.
  161.  
  162.     expire <filename>   (<filename> should be explist, otherwise edit
  163.                 the doexpire script)
  164.  
  165.         Expires all articles under the conditions set by you
  166.         in <filename>.  Any errors will appear on stdout. See BEWARE
  167.         in doexpire below.
  168.  
  169.     doexpire
  170.  
  171.         A simple batch file to run expire, activeupdate, and mkdbz
  172.         to complete maintenance.  Disables new connections to NNTPd
  173.         with a "Maintenance in progress" message. BEWARE that any
  174.         established connections do not exist or there will be trouble
  175.         with locks on files.
  176.  
  177. activeupdate
  178.  
  179.     Updates your active file based on the articles that actually exist
  180.     in your subdirectories.  Usually run after an expire.
  181.  
  182. activetimesmaker
  183.  
  184.     Creates the file active.times, with a list of all groups you have
  185.     listed in active.  Usually only run once on installation.
  186.  
  187. mkhistory/histinfo
  188.  
  189.     Mkhistory makes a history database in uunews called history, with
  190.     support files history.dir and history.pag.  These make running the
  191.     daemon faster, and speeds the task of expiring articles tremendously.
  192.     It is only run once during the initial setup of your news system.
  193.  
  194. unixsort
  195.  
  196.     A sort program that accepts unix-style sorting commands.  Used by
  197.     mkhistory and mkdbz frequently as well as other programs.
  198.  
  199. mkdbz/dbz
  200.  
  201.     dbz - No manpages or info available.  Creates history.dir and
  202.           history.pag to speed access to your history file in locating
  203.           database entries.
  204.  
  205.     mkdbz - Used by doexpire. Updates history.dir and history.pag after
  206.         an expire, usually after daily maintenance work.  Uses
  207.         unixsort and dbz.
  208.  
  209. newgroup <newgroupname>
  210.  
  211.     Adds the <newgroupname> to both your active file and your active.times
  212.     file, and creates any subdirectories required if they don't exist.
  213.  
  214. initov
  215.  
  216.     Creates the .overview files in each subdirectory.  Takes a long time
  217.     if you have an extensive news system already installed, but only run
  218.     once during the initial installation.
  219.  
  220. expov/expovguts
  221.  
  222.     Removes expired overview entries.  Usually run after expire.
  223.  
  224. domkov <filename>
  225.  
  226.     Takes the headers from uunews:headers and places the information in
  227.     the .overview files.  The <filename> is ALWAYS uunews:headers.
  228.  
  229.  
  230. batchproc
  231.  
  232.     This program extracts the batched articles from your out.master
  233.     directory and places that article path names in files named after
  234.     their destination hosts.  Then it calls Michael van Elst's nntpput
  235.     to forward the articles to the destination server.
  236.  
  237.     This program uses the IHAVE command to feed articles from your
  238.     system to another system.  You must have IHAVE feed permission on the
  239.     destination server to use this command.  IF YOU DONT HAVE IHAVE
  240.     permission, but you have POST permission, attach a -p to the batchproc
  241.     command (i.e. bin/batchproc -p) to use the POST command.  Note that
  242.     this is NOT the preferred way to feed mail to another server as you'll
  243.     probably wind up with your own articles again when you receive a news
  244.     feed.
  245.  
  246.